[docs] Move documentation to inline comments: GtkAspectFrame

Fixes https://bugzilla.gnome.org/show_bug.cgi?id=611958

Signed-off-by: Javier Jardón <jjardon@gnome.org>

diff --git a/docs/reference/gtk/tmpl/gtkaspectframe.sgml b/docs/reference/gtk/tmpl/gtkaspectframe.sgml
deleted file mode 100644 (file)
index 25d05e8..0000000
--- a/docs/reference/gtk/tmpl/gtkaspectframe.sgml
+++ /dev/null
@@ -1,88 +0,0 @@
-<!-- ##### SECTION Title ##### -->
-GtkAspectFrame
-
-<!-- ##### SECTION Short_Description ##### -->
-A frame that constrains its child to a particular aspect ratio
-
-<!-- ##### SECTION Long_Description ##### -->
-<para>
-The #GtkAspectFrame is useful when you want
-pack a widget so that it can resize but always retains
-the same aspect ratio. For instance, one might be
-drawing a small preview of a larger image. #GtkAspectFrame
-derives from #GtkFrame, so it can draw a label and
-a frame around the child. The frame will be
-"shrink-wrapped" to the size of the child.
-</para>
-
-<!-- ##### SECTION See_Also ##### -->
-<para>
-
-</para>
-
-<!-- ##### SECTION Stability_Level ##### -->
-
-
-<!-- ##### STRUCT GtkAspectFrame ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### ARG GtkAspectFrame:obey-child ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkAspectFrame:ratio ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkAspectFrame:xalign ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkAspectFrame:yalign ##### -->
-<para>
-
-</para>
-
-<!-- ##### FUNCTION gtk_aspect_frame_new ##### -->
-<para>
-Create a new #GtkAspectFrame.
-</para>
-
-@label: Label text.
-@xalign: Horizontal alignment of the child within the allocation of
-the #GtkAspectFrame. This ranges from 0.0 (left aligned)
-to 1.0 (right aligned)
-@yalign: Vertical alignment of the child within the allocation of
-the #GtkAspectFrame. This ranges from 0.0 (left aligned)
-to 1.0 (right aligned)
-@ratio: The desired aspect ratio.
-@obey_child: If %TRUE, @ratio is ignored, and the aspect
-    ratio is taken from the requistion of the child.
-@Returns: the new #GtkAspectFrame.
-<!-- # Unused Parameters # -->
-@ratio: The desired aspect ratio.
-
-
-<!-- ##### FUNCTION gtk_aspect_frame_set ##### -->
-<para>
-Set parameters for an existing #GtkAspectFrame.
-</para>
-
-@aspect_frame: a #GtkAspectFrame
-@xalign: Horizontal alignment of the child within the allocation of
-the #GtkAspectFrame. This ranges from 0.0 (left aligned)
-to 1.0 (right aligned)
-@yalign: Vertical alignment of the child within the allocation of
-the #GtkAspectFrame. This ranges from 0.0 (left aligned)
-to 1.0 (right aligned)
-@ratio: The desired aspect ratio.
-@obey_child: If %TRUE, @ratio is ignored, and the aspect
-    ratio is taken from the requistion of the child.
-
-

diff --git a/gtk/gtkaspectframe.c b/gtk/gtkaspectframe.c
index db0a839454d2db5d007306439da29ff0439b497f..beedd19c2c9aace29ac750f0f6959b8879dcab72 100644 (file)
--- a/gtk/gtkaspectframe.c
+++ b/gtk/gtkaspectframe.c
@@ -29,6 +29,20 @@
  * GTK+ at ftp://ftp.gtk.org/pub/gtk/. 
  */
 
+/**
+ * SECTION:gtkaspectframe
+ * @Short_description: A frame that constrains its child to a particular aspect ratio
+ * @Title: GtkAspectFrame
+ *
+ * The #GtkAspectFrame is useful when you want
+ * pack a widget so that it can resize but always retains
+ * the same aspect ratio. For instance, one might be
+ * drawing a small preview of a larger image. #GtkAspectFrame
+ * derives from #GtkFrame, so it can draw a label and
+ * a frame around the child. The frame will be
+ * "shrink-wrapped" to the size of the child.
+ */
+
 #include "config.h"
 #include "gtkaspectframe.h"
 #include "gtkprivate.h"
@@ -185,6 +199,23 @@ gtk_aspect_frame_get_property (GObject         *object,
     }
 }
 
+/**
+ * gtk_aspect_frame_new:
+ * @label: Label text.
+ * @xalign: Horizontal alignment of the child within the allocation of
+ *  the #GtkAspectFrame. This ranges from 0.0 (left aligned)
+ *  to 1.0 (right aligned)
+ * @yalign: Vertical alignment of the child within the allocation of
+ *  the #GtkAspectFrame. This ranges from 0.0 (left aligned)
+ *  to 1.0 (right aligned)
+ * @ratio: The desired aspect ratio.
+ * @obey_child: If %TRUE, @ratio is ignored, and the aspect
+ *  ratio is taken from the requistion of the child.
+ *
+ * Create a new #GtkAspectFrame.
+ *
+ * Returns: the new #GtkAspectFrame.
+ */
 GtkWidget*
 gtk_aspect_frame_new (const gchar *label,
                      gfloat       xalign,
@@ -206,6 +237,21 @@ gtk_aspect_frame_new (const gchar *label,
   return GTK_WIDGET (aspect_frame);
 }
 
+/**
+ * gtk_aspect_frame_set:
+ * @aspect_frame: a #GtkAspectFrame
+ * @xalign: Horizontal alignment of the child within the allocation of
+ *  the #GtkAspectFrame. This ranges from 0.0 (left aligned)
+ *  to 1.0 (right aligned)
+ * @yalign: Vertical alignment of the child within the allocation of
+ *  the #GtkAspectFrame. This ranges from 0.0 (left aligned)
+ *  to 1.0 (right aligned)
+ * @ratio: The desired aspect ratio.
+ * @obey_child: If %TRUE, @ratio is ignored, and the aspect
+ *  ratio is taken from the requistion of the child.
+ *
+ * Set parameters for an existing #GtkAspectFrame.
+ */
 void
 gtk_aspect_frame_set (GtkAspectFrame *aspect_frame,
                      gfloat          xalign,